docs: fill in some missing field descriptions

docs: mark some enums values as deprecated

docs: avoid ambiguous return tags

docs: fix docs for out params

docs: don't use gtkdoc style for regular comments

GtkStack: add gtk_stack_get_child_by_name()

This new method allows getting a widget from a GtkStack when we know its
name, and will also return NULL if there is no widget going by that
name.

Usage example would be to check if a child with a given name exists
before calling gtk_stack_set_visible_child_name().

https://bugzilla.gnome.org/show_bug.cgi?id=722588

Tajik translation updated

docs: add GdkFrameClock to types

docs: remove reference to function that doesn't exist

docs: fix typo in function name

docs: fix typo in parameter name

docs: fix typo in type name

docs: use GDK_KEY_* names in docs

docs: add GdkModifierIntent to docs

docs: fix typos in class names

docs: remove reference to nonexistant api

Refers to an uncommitted part of
https://bugzilla.gnome.org/show_bug.cgi?id=696001

docs: fix typo in function name

docs: zero is a literal not a type link

docs: fix typo in doc syntax

docs: fix typo in type name

docs: fix typo in type name

docs: fix type in parameter type

docs: remove link to missing example

Removed in e95490c15e8a95cb72601e4d66e806b55d7b4d82 etc.

docs: add docs for GtkFrameClock

docs: fix docs for GDK_XID_TO_POINTER and GDK_POINTER_TO_XID

docs: fix typo in GDK_WINDOW_STATE_TILED

docs: add missing scroll delta fields

docs: add missing GdkEvent field names

docs: add missing docs for GDK_MODIFIER_RESERVED_*_MASK

Updated Galician translations

Updated Galician translations

docs: add docs for GtkTargetPair

wayland: fix rename of wl_shell to xdg_shell

Regression from 9127087e1c0e93f94552f0ad5170d4dfa785146a

docs: add missing docs for GDK_DISABLE_DEPRECATION_WARNINGS

docs: add missing docs for GDK_WINDOWING_WAYLAND

docs: add missing overrides for QUARTZ and WAYLAND

docs: put GtkWindow above subclasses

docs: add Gtk*Class docs

https://bugzilla.gnome.org/show_bug.cgi?id=81006

Remove references to removed gtk_item_select api

Updated Spanish translation

Updated Spanish translation

Updated Brazilian Portuguese translation

Updated Brazilian Portuguese translation

Make sure title_bar_with is initialized

With a hidden custom title, we failed to initialize
the title_bar_width variables.

path bar: Request enough natural width to fit all buttons

Otherwise, we are at the mercy of the container giving us
more space than we request, which does not always work.

Updated Hebrew translation

Updated POTFILES.skip

a11y tests: Fix expected output of about.ui

a11y tests: Fix settings that affect a11y output

It would be nicer if we could have the tests specify what environment
their expected output was created in, then we could test multiple
scenarios. For now, just fix the setting to avoid test failures.

Updated POTFILES.skip

Update Chinese simplified translation for ui and properties

quartz: add a default application menu

When running on quartz, it is no longer expected for applications to
provide their own application menu.  Instead, they should simply ensure
that they provide "app.about", "app.preferences" and "app.quit" actions
(which many apps are already doing).

A default menu will be shown that looks like the one presented by all
other Mac OS applications, containing menu items for the above actions,
as well as the typical "Hide app", "Hide Others and "Show All" items and
the "Services" submenu.

If an application does explicitly set an application menu (via
gtk_application_set_app_menu()) then it will be respected, as before.

https://bugzilla.gnome.org/show_bug.cgi?id=720552

extract-strings: support GMenu GtkBuilder markup

Add support for extracting strings from GMenu markup in GtkBuilder
files.

This means that we have to support translatable <attribute/> tags.

Unfortunately, <attribute> is also used by GtkTreeViewColumn and
GtkLabel for other purposes, and those other purposes use a value=''
(XML) attribute, so we must accept (and ignore) that in order not to
have errors.  Nothing will happen in those cases because they do not
also specify translatable='yes', so we ignore them.

https://bugzilla.gnome.org/show_bug.cgi?id=720552

application: new 'insert action group' private api

Add a new private API to GtkApplication akin to
gtk_widget_insert_action_group().

We'll use this to insert a few extra actions at the app level with a
separate namespace for the special items in the Mac OS application menu.

https://bugzilla.gnome.org/show_bug.cgi?id=720552

quartz menu: add a hack for application name

Add a private hack to allow the insertion of the name of the application
into the label of menu items.

If it appears in the label of any menu item, "%s" will be replaced with
the name of the application.

We will use this for the "Hide myapp", "Quit myapp" and "About myapp"
labels typically found on Mac OS programs.

https://bugzilla.gnome.org/show_bug.cgi?id=720552

quartz menu: add special items

Add support for the "Hide app", "Hide Others" and "Show All" special
items and for the "Services" submenu.

https://bugzilla.gnome.org/show_bug.cgi?id=720552

docs/comments: Fix spelling of 'explicitly'

This replaces all occurrences of 'explicitely' with 'explicitly'. Only
code comments and gtk-doc statements are affected.

https://bugzilla.gnome.org/show_bug.cgi?id=722429

GtkMenuTracker: add 'special' items

Allow the possibility for items to be marked with a special attribute and
expose this via GtkTrackerMenuItem.  For internal use only.

We will use this to implement the special 'Hide', 'Hide Others' and 'Show All'
items and the 'Services' submenu in the Mac OS application menu.

https://bugzilla.gnome.org/show_bug.cgi?id=720552

quartz menu: change sensitivity approach

By default, Mac OS scans menus as they are opened, updating the
sensitivity of each item in the menu.

The current code in gtkapplication-menu-quartz disables this behaviour,
preferring to manually control the sensitivity of each item in the menu
(when told by the tracker that it has changed internally).

Change the way that this works to more closely follow the usual Mac OS
regime.

This will allow us to construct a typical "application menu" on Mac OS
containing the items that are typically found there ("Hide", "Hide
Others", "Show All", "Services") and have the OS automatically update
their sensitivity.

https://bugzilla.gnome.org/show_bug.cgi?id=720552

header bar: Make it possible to have no title

Add a custom title had the side-effect of showing the widget.
That is not right, adding children and managing their visibility
should be independent. The headerbar size allocation code also
made the assumption that a custom title is always visible.

With these changes, GtkHeaderBar should be usable in situations
where the centering functionality is not required, and it is
important to freely pack content at both ends, such as in nautilus.

https://bugzilla.gnome.org/show_bug.cgi?id=722340

Update colorchooser.ui test output

These are expected changes from the last few commits.

Update messagedialog.ui test output

These are expected changes from the last few commits.

mount operation: Use headerbar

Make GtkMountOperation use a headerbar for its dialog
when desired.

recent chooser dialog: Use headerbar

Make the recent chooser dialog use a headerbar
when desired.

https://bugzilla.gnome.org/show_bug.cgi?id=720059

file chooser dialog: Use headerbar

Make the file chooser dialog use a headerbar
when desired.

https://bugzilla.gnome.org/show_bug.cgi?id=720059

custom paper dialog: Use headerbar

Make the custom paper dialog use a headerbar when desired.

https://bugzilla.gnome.org/show_bug.cgi?id=720059

page setup dialog: Use headerbar

Make the page setup dialog use a headerbar when desired.

https://bugzilla.gnome.org/show_bug.cgi?id=720059

print dialog: Use headerbar

Make the print dialog use a headerbar when desired.

https://bugzilla.gnome.org/show_bug.cgi?id=720059

app chooser: Use headerbar

Use a GtkHeaderBar in the app chooser dialog when desired.

https://bugzilla.gnome.org/show_bug.cgi?id=720059

color chooser: Use headerbar

Make GtkColorChooserDialog use a headerbar when desired.

https://bugzilla.gnome.org/show_bug.cgi?id=720059

font dialog: Use headerbar

Make the font chooser dialog use a headerbar
when desired.

https://bugzilla.gnome.org/show_bug.cgi?id=720059

about dialog: Use headerbar

Use a GtkHeaderBar for the credits and about buttons.

It makes less sense here than in other places to go back to
the buttons on the bottom, considering we only have a close
button, so we always use a header bar.

https://bugzilla.gnome.org/show_bug.cgi?id=720059

dialog: Show the action area when needed

If we find that widgets are being added to the action area,
we should show it. Also warn in this situation.

Exclude use-header-bar from the defaultvalue test

Make it possible to set use-header-bar from a setting

This commit introduces a private convenience API that derived
dialogs can call in their instance init. This is necessary to
make the setting work as intended in the face of 3rd party
dialogs derived e.g. from GtkFileChooserDialog, which are
created with g_object_new.

Add a setting for dialog headers

This setting will let us keep traditional appearance
of dialogs on platforms where this is expected.
The new setting is called gtk-dialogs-use-header, backed
by the Gtk/DialogsUseHeader xsetting.

demo: Add two buttons to the message dialog

This tests the new. prompt-like layout of message dialogs
better.

https://bugzilla.gnome.org/show_bug.cgi?id=720059

message dialog: Center text

https://bugzilla.gnome.org/show_bug.cgi?id=720059

message dialog: Don't show images

https://bugzilla.gnome.org/show_bug.cgi?id=720059

message dialog: Allow action area to extend to the edge

https://bugzilla.gnome.org/show_bug.cgi?id=720059

message dialog: Don't use headerbar

https://bugzilla.gnome.org/show_bug.cgi?id=720059

dialog: Add style classes

These will be used in subsequent commits to better style
message dialogs.

dialog: Add a headerbar

This change makes it possible for GtkDialog to pack
its action widgets into a header bar, instead of the
traditional action area. This change is controlled
by the use-header-bar construct-only property.

https://bugzilla.gnome.org/show_bug.cgi?id=720059

Update all internal users of alternative button order

We'll keep this code around for now to not regress
on Windows, but avoid deprecation warnings.

dialog: Mark alternate button order as deprecated

This feature was never implemented 100% correct, and
does not apply to action buttons in header bars.

https://bugzilla.gnome.org/show_bug.cgi?id=720059

file chooser: Clean up direct action area interaction

Update all internal users of gtk_dialog_get_action_area

Some of these should be revisited and fixed. For now,
just avoid the deprecation warnings.

dialog: Mark gtk_dialog_get_action_area as deprecated

Direct access to the action area by applications makes it much more
difficult to make changes to GtkDialog. Therefore, deprecate this
function.

demo: Add new button box layouts

This adds a test case for the new expand layout.

https://bugzilla.gnome.org/show_bug.cgi?id=720059

button box: Set linked style for extend

This is needed for proper styling of the new extend-placement
in button boxes.

Add an expand button box type

https://bugzilla.gnome.org/show_bug.cgi?id=720059

window: Allow unsetting custom titlebar

https://bugzilla.gnome.org/show_bug.cgi?id=720059

headerbar: Set a minimum size for the title

https://bugzilla.gnome.org/show_bug.cgi?id=720059

Use gtk_window_close for gtk_dialog_close

We manually synthethized the delete event, but now we have the
corresponding method in GtkWindow

widget: Add deprecation annotations for {get,set}_margin_{left,right}

Fallout from 9921bec63a3e67e2c2e38ca734590909a9f734b5

[l10n] Updated Estonian translation

Updated Spanish translation

Updated POTFILES.skip

Bump version

Always return FALSE from the notebook leave_notify handler

As discussed on IRC with Benjamin, this should not make much
difference in practice, but it is more correct